MixRadio_Mac - Ver M-4.4.10
VERSIONE CORRENTE: MixRadio_Mac - Ver M-4.4.10

PRIMA INSTALLAZIONE: copia lo ZIP sul Mac e aprilo con un doppio clic (usa lo zip, cosi' i file .command restano eseguibili), poi clic destro su "INSTALLA SU MAC.command" -> Apri (la prima volta conferma "Apri").
Lo script scarica da solo il motore (Electron, circa 100 MB, serve internet) e crea "Mix Radio.app" in ~/Applications. Senza internet: metti il file electron-vXX.X.X-darwin-arm64.zip (chip Apple) o ...-darwin-x64.zip (Intel) nella cartella "Runtime" (il nome esatto del file e' nei commenti dello script). Poi apri Mix Radio e consenti il microfono.

COME AGGIORNARE UNA REGIA GIA' INSTALLATA: estrai lo zip nuovo in una cartella nuova, chiudi la regia (FUORI ONDA se sei in onda), poi esegui "AGGIORNA SU MAC.command". Dettagli nel manuale (capitolo 25).

--------------------------------------------------------------------------------------------------------------------------

NOVITA' DI QUESTA VERSIONE (4.4.10):
- AVVISO DJ IN ONDA piu' affidabile: se il sito non ha il file api/regia_onair.php (o non risponde), il mixer legge lo stato "DJ in diretta" dalla pagina pubblica api/public_stations.php, che c'e' su ogni sito. Cosi' premendo VAI IN ONDA con un altro DJ gia' collegato compare l'avviso rosso anche senza installare nulla sul server.
- VIDEO IN DIRETTA: nel Kit API c'e' ora anche patch_video_diretta_sito.py (da lanciare dopo patch_video_diretta.py, 'python3 patch_video_diretta_sito.py .'): fa vedere agli ascoltatori il video inviato dal mixer mentre un DJ e' in diretta.

PRECEDENTI (4.4.9):
- Impostazioni, sezione Console: nuovo menu "Chiusura diretta - bottone FUORI ONDA". SENZA CONFERMA = premendo FUORI ONDA esci subito dalla trasmissione; CONFERMA ABILITATA = chiede conferma prima di uscire (come prima, resta il valore di partenza).

- AVVISO DJ IN ONDA: premendo VAI IN ONDA il mixer controlla subito il sito; se un altro DJ e' gia' in diretta compare l'avviso rosso e non parte nulla. SITO: rilancia UNA VOLTA 'python3 patch_regia_onair.py .' dalla cartella principale (ora usa lo stesso controllo Liquidsoap della card pubblica; backup automatico del vecchio file). Il pannello VPS 2.0.9 lo contiene gia'.

PRECEDENTI (4.4.8):
- Corretto un difetto di impaginazione della 4.4.7 (pannelli in basso schiacciati, liste che sparivano). Gli avvisi DJ/ospiti restano uguali e non spostano piu' nulla.
- Sotto "ACCENDI LA CONSOLE" compare "Vers. W-4.4.8" (Mac M, iPad I).
- Windows: bottoni + - A schermo pieno e formato piu' grandi (25x20 invece di 17x13); la barra in alto non cambia altezza.

PRECEDENTI (4.4.7):
- AVVISO "(NOME) E' IN ONDA": se accendi il mixer mentre un DJ e' in diretta sulla radio, compare in alto (rosso, come FUORI ONDA) il nome del DJ
  con la scritta "invio bloccato finche' non esce dalla diretta". Finche' resta visibile VAI IN ONDA e' spento e i comandi "Trasmetti ora" e
  "Va in coda" dei video non partono: cosi' non si copre la sua diretta. L'avviso sparisce da solo appena il DJ esce.
- AVVISO "OSPITI IN CODA: n": se ci sono ospiti che chiedono di entrare e non li hai ancora accettati, compare un avviso rosso con il numero
  (non dimenticarli); sparisce quando non ce ne sono piu' in attesa. Si gestiscono dalla scheda OSPITI.
  SITO: per l'avviso del DJ lancia UNA VOLTA dalla cartella principale del sito 'python3 patch_regia_onair.py .' (serve prima patch_regia_videos.py;
  installa api/regia_onair.php, backup e php -l, rilanciabile). Senza quel file il mixer funziona come prima, senza avviso del DJ.
  L'avviso del DJ non compare quando sei tu in onda.

PRECEDENTI (4.4.6):
- RITRASMISSIONE ON AIR: quando mandi in onda un flusso che ricevi (tasto ON AIR del sintonizzatore URL), la scheda "in onda" del sito
  (titolo mostrato agli ascoltatori) riporta "Ritrasmissione da: [dominio della web radio]". Quando spegni ON AIR torna il titolo normale.
- RITRASMISSIONE ON AIR + JINGLE: quando parte un jingle, l'audio della ritrasmissione scende subito a zero e passa solo il jingle;
  a fine jingle la ritrasmissione torna a livello pieno.

PRECEDENTI (4.4.5b):
- VIDEO con regia IN ONDA: "Trasmetti ora" ora e' immediato. Il brano che sta suonando va in pausa, l'audio del video esce dal mixer
  (come un jingle) e il video compare sullo schermo; a fine video i brani ripartono da dove erano. Prima il comando andava al sito,
  che lo metteva in coda dietro la diretta: per questo il video non partiva. Con la regia FUORI ONDA non cambia nulla. "Va in coda" non cambia.
  SITO: per far vedere il video anche agli ascoltatori mentre sei in diretta, sul sito lancia UNA VOLTA dalla cartella principale
  'python3 patch_video_diretta.py .' (serve prima patch_regia_videos.py; backup automatico, php -l, rilanciabile). Il mixer non mette nulla in coda sul sito.
  A fine video il mixer rimanda il titolo del brano che riprende.

PRECEDENTI (4.4.4):
- AVVISO PROGRAMMAZIONE: quando sei in onda e la web radio manda in onda un passaggio programmato (Programmazione brani del pannello 2.0.3 o superiore),
  la tua diretta va in pausa da sola e riprende da sola alla fine. Ora MIX RADIO te lo dice con un riquadro in alto al centro:
  arancione 'TRA POCO PROGRAMMAZIONE' (parte al prossimo cambio brano), rosso 'PROGRAMMAZIONE IN ONDA - sei in pausa' con il conto alla rovescia
  fino alla ripresa, verde 'DIRETTA RIPRESA' per 4 secondi. Resti collegato: quello che trasmetti nella pausa non va in onda.
  Serve il pannello Web Radio 2.0.4 o superiore (api/regia_trasmissione.php). Con un pannello piu' vecchio o con il Server indipendente non compare nulla e
  il resto funziona come prima. Usa utente, password e indirizzo del sito gia' inseriti negli Accessi DJ: nessuna impostazione nuova.

PRECEDENTI (4.4.3):
- Manuale: la pagina 3 (capitolo 1) ora riporta il Disclaimer sotto il titolo e non cita piu' la cartella dei file di vendita. Il piede di pagina
  del manuale riporta ora la versione corretta. Nessun'altra modifica al programma.

PRECEDENTI (4.4.2):
- Il tasto FADE e' un po' piu' basso e la scritta ha il colore "Testo tenue e scale" del gestore dei colori (cambia se cambi quel colore).
  Resta sotto il bottone di accesso alla radio, della stessa larghezza. Il funzionamento della dissolvenza non cambia.
- Manuale aggiornato.

PRECEDENTI (4.4.1):
- Il tasto FADE e' ora GRANDE, come il bottone di accesso alla radio, e si trova subito sotto di esso (prima era piccolo accanto al
  crossfader). Il funzionamento della dissolvenza non cambia (dal piatto in onda al prossimo pronto, tasto F).
- Manuale aggiornato.

PRECEDENTI (4.4.0):
- NUOVO BOTTONE "SET AUDIO" (icona cuffie) nella barra in alto a destra, prima del microfono degli accessi DJ. Apre un pannello a due
  colonne: MICROFONO e USCITA AUDIO. In verde c'e' scritto cio' che e' in uso ora, sotto l'elenco delle periferiche disponibili.
  Il tasto SET salva la scelta e la applica subito; se sei in onda il cambio avviene senza interrompere la diretta.
  La scelta resta memorizzata anche alla prossima apertura.
- Manuale aggiornato (capitolo SET AUDIO).

PRECEDENTI (3.4.0):
- LED SPIA con una piccola corona metallica accanto al titolo dei cursori PROCESSORE, MUSICA, JINGLE, MIC e MASTER OUT
  (MASTER USCITA ora si chiama MASTER OUT). Spenti se non sei in onda; con FUORI ONDA sono ROSSI e diventano VERDI quando accendi
  l'interruttore alla base del cursore. MASTER OUT e' verde quando sei collegato alla web radio.
- LED della radio: a sinistra, sopra il bottone della radio (riga della licenza). VERDE con leggera pulsazione quando la regia
  ascolta la radio, ROSSO mentre cambia radio o quando non riceve il flusso.
- I cursori sono un po' piu' larghi. Alla fine del video la scheda VIDEO si chiude da sola.
- Script server aggiornati (patch_video_dedup.py, patch_video_unavolta.py). Manuale aggiornato.

PRECEDENTI (3.3.0):
- NUOVA SCHEDA "VIDEO" dopo Playlist (barra Coda / Cronologia / Playlist). Non premuta, la regia e' identica a prima.
  Premuta: si apre la playlist dei video MP4 della web radio, con scelta "Tutta la playlist" o "Singolo brano",
  uno schermo 16:9 accanto all'equalizzatore (doppio clic = schermo intero), i tasti "Trasmetti ora" (parte subito)
  e "Va in Coda" (parte alla fine del brano in corso) e, sotto, il conto alla rovescia "to end" fino a zero.
  Una riga gialla mostra il video scelto / in coda / in onda. Premendo di nuovo VIDEO la regia torna come prima.
  "Trasmetti ora" = "Metti in onda ora" del pannello. La playlist e' quella della "Playlist Video" della web radio
  (si carica da sola; "Aggiorna elenco" la ricarica).
  Sul sito va installato una volta api/regia_videos.php: nella cartella "Kit API (modelli)/Server con pannello radio"
  esegui sul server: python3 patch_regia_videos.py /percorso/del/sito
  poi python3 patch_video_dedup.py /percorso/del/sito e python3 patch_video_unavolta.py /percorso/del/sito
  (evitano che il video parta due volte).
- Se la musica del sito parte prima o dopo il video, regola "ritardo" (secondi interi) nelle impostazioni Playlist Video.
- Manuale aggiornato (capitolo 27).

PRECEDENTI (3.2.4):
- Aggiunto un tema scuro (stile console) tra i temi di colore già presenti: si trova nel pulsante con la tavolozza in alto, scegliendolo da "Applica tema" nella finestra Colori. I temi e i colori di sempre restano identici, il tema di partenza resta quello arancio.
- Aggiunto il pulsante "help" che apre direttamente il manuale in PDF. Se sul Mac manca un programma per leggere i PDF, il pulsante lo segnala e consiglia di installarne uno (per esempio Anteprima o Adobe Acrobat Reader).
- Tolti i riferimenti a una stazione specifica (nome del programma, esempi): gli avvisi di sistema mostrano "Buildweb ISP", gli inviti agli ospiti (WhatsApp, e-mail) riportano il nome della tua stazione.

- DIMENSIONE DELL'INTERFACCIA: cinque tastini sotto il logo, in alto a sinistra (la barra ha la stessa altezza di prima):
  + ingrandisce, - rimpicciolisce (60%-160%), A torna all'adattamento automatico, schermo pieno senza contorni, ■ menu del
  formato della finestra (Libero, 16:9, 16:10, 4:3, 21:9, 1:1, 9:16). Se lo schermo e' piccolo la console si rimpicciolisce da sola
  per entrare tutta. Dimensione e formato restano memorizzati.
- Manuale aggiornato (capitolo 25).

DIFFERENZE DAL WINDOWS
- Il CodeUnik e' quello del Mac (computer in piu' per la licenza).
- L'aggiornamento automatico non installa su Mac: si usa AGGIORNA SU MAC.
- Menu standard del Mac (Cmd+Q, copia/incolla); al posto di Ctrl+R vale anche Cmd+R.

NON PROVATO: il programma non e' stato provato su un Mac vero (qui non c'e' macOS): la parte audio e' la stessa del Windows
provata in Chromium; installazione, firma e permesso microfono vanno verificati sul tuo Mac.
